Installation

Gusto using OAuth 2.0 Authorization Code grant. Both production (api.gusto.com) and sandbox (api.gusto-demo.com, registered as gustoDemo) are supported.

• Connector uses internal/components
• Metadata uses V2 metadata format
• Read supports pagination and incremental sync
• Raw response is returned as is for READ & METADATA, no formatting or flattening is performed.
• Write payloads should accept what ReadResults.Fields is returning. Any unnecessary nesting around the input is removed.
• Provider errors are mapped if non-standard (errors with 200 response code are converted to 4XX)
• Custom fields, if not human readable names, are resolved to readable names.
• Unit tests cover read/write/metadata logic (placed in /tests/)
• Appropriate object names are used. Objects need to be resources, not actions (jobs and not jobs.list).
• Modules are only being added because:
  • They share the same authentication scheme
  • The same base URL cannot be used to make a proxy call to objects in all modules
  • Different base URLs (drive.google.com vs google.com)
  • Object name collisions (same object name exists in two or more modules)

Summary

Adds Write + Delete support for the Gusto deep connector.

Object scope (17 objects):

• Company-scoped CREATE: employees, locations, departments, contractors, payrolls, pay_schedules, earning_types, company_benefits, admins, contractor_payments, custom_fields
• Employee-scoped CREATE (employee_id from RecordData): jobs, employee_benefits, garnishments, home_addresses, work_addresses
• Job-scoped CREATE (job_id from RecordData): compensations
• Top-level UPDATE (PUT /v1/{object}/{uuid}, version-required): all of the above
• Company-scoped UPDATE (PUT /v1/companies/{cid}/{object}/{uuid}): earning_types, pay_schedules, payrolls
• Update-only: companies
• Create-only: admins, contractor_payments
• DELETE (where Gusto exposes it): employees, jobs, compensations, home_addresses, work_addresses, employee_benefits, company_benefits, departments, earning_types

Unit Tests

Write

Delete

Live Tests